"""drf_tutorial URL Configuration

The `urlpatterns` list routes URLs to views. For more information please see:
    https://docs.djangoproject.com/en/4.1/topics/http/urls/
Examples:
Function views
    1. Add an import:  from my_app import views
    2. Add a URL to urlpatterns:  path('', views.home, name='home')
Class-based views
    1. Add an import:  from other_app.views import Home
    2. Add a URL to urlpatterns:  path('', Home.as_view(), name='home')
Including another URLconf
    1. Import the include() function: from django.urls import include, path
    2. Add a URL to urlpatterns:  path('blog/', include('blog.urls'))
"""
from django.contrib import admin
from django.urls import path, include
from rest_framework import permissions
from rest_framework.authtoken import views


# 1 普通文档
# from rest_framework.schemas import get_schema_view
# schema_view = get_schema_view(title="DRF API 文档", description="xxx")
# path('schema/',schema_view),
# 2 优化文档
# from rest_framework.documentation import include_docs_urls
# path('docs', include_docs_urls(title="DRF API文档", description="xxx")),

# 3 swagger 文档
# 安装 drf-yasg
from drf_yasg import openapi
from drf_yasg.views import get_schema_view

schema_view = get_schema_view(
    # API 信息
    openapi.Info(
        title='Swagger API',  # API文档标题
        default_version='V1',  # 版本信息
        description='Swagger 接口文档',  # 描述内容
        terms_of_service='https://test.com',  # 开发团队地址
        contact=openapi.Contact(email='https://test.@163com', url='https://test.com'),  # 联系人信息：邮件、网址
        license=openapi.License(name='Test License'),  # 证书
    ),
    public=True,  # 是否公开
    permission_classes=(permissions.AllowAny,)  # 设置用户权限
)

urlpatterns = [
    path('swagger/',schema_view.with_ui('swagger',cache_timeout=0),name="swagger"), # 互动模式
    path('redoc/',schema_view.with_ui('redoc',cache_timeout=0),name="redoc"), # 文档模式
    
    path('api-token-auth/', views.obtain_auth_token),  # 获取Token的接口
    path('api-auth/', include('rest_framework.urls')),
    path('admin/', admin.site.urls),

    path('course/', include('course.urls'))
]
